home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Gold Collection / Software Vault - The Gold Collection (American Databankers) (1993).ISO / cdr36 / doorst11.zip / DOORSTOP.DOC < prev    next >
Text File  |  1993-06-24  |  14KB  |  368 lines
  1.  
  2.       +--------------------------------------------------------+
  3.       | DOORSTOP, (C) Copyright 1991-93 Scott Johnson for      |
  4.       |                   Jibben Software                      |
  5.       |                     Version 1.10                       |
  6.       +--------------------------------------------------------+
  7.  
  8.  
  9. This is a list of the files that should accompany this software
  10. package:
  11.  
  12. DOORSTOP.DEF - Example Doorstop Configuration File.
  13. FILE_ID.DIZ  - BBS Description File.
  14. DOORSTOP.DOC - Doorstop Documentation.
  15. ORDERFRM.DOC - The order form.
  16. WHATSNEW.DOC - The Version History of Doorstop
  17. DOORSTOP.EXE - Doorstop executable.
  18. CATALOG.JSW  - Information on current Jibben Software Products.
  19. DOOR.SYS     - Dummy DOOR.SYS file for running Doorstop locally.
  20. AVEXTRA.TXT  - Information regarding PKZIP AV codes.
  21. DM.BAT       - Batch file for running Doorstop locally as a test
  22. NAMES.LST    - Sample name exclude/include list
  23. WHATSNEW.TXT - Text file containing the history of the software.
  24.  
  25. This software should not include any other files other than the ones
  26. listed above.  It was also compressed using the PKZIP AV.
  27.  
  28.  
  29.         Shareware Trade Association & Resources
  30.  
  31. Scott Johnson is a charter member of STAR!  STAR is the shareware
  32. industries fastest growing trade association.
  33.  
  34. To obtain other fine software from members of STAR, please contact the
  35. Software Creations BBS.  It is the hub of the STAR distribution network
  36. supporting 53 phone lines.  To access Software Creations, you may call
  37. the following numbers:
  38. (508) 365-2359 - 2400 baud
  39. (508) 368-4137 - US Robotics HST
  40. (508) 368-7423 - Dual Standard, V.32bis
  41.  
  42. Please contact The Warehouse BBS for TECHNICAL SUPPORT at:
  43. (612) 379-8272 - Dual Standard, V.32bis (6 phone lines)
  44.  
  45.  
  46.                The concept of Shareware
  47.  
  48. Doorstop is being released as a Shareware product.  Shareware is a
  49. marketing concept, in which you get to try out a software package for
  50. a period of time.  If you find that the software is useful to you (you
  51. are still using it), you are obligated to send in a registration fee
  52. for that software to the author.
  53.  
  54. Doorstop trial period is 21 days.  That means, once you start using
  55. Doorstop, you have 21 days to decide whether or not it is useful to you.
  56. If it is useful, please promptly send in the requested registration fee.
  57. If it is not useful, you are expected to delete it and stop using it.
  58.  
  59. The shareware version of Doorstop is functional.  However, it will post
  60. this annoying message to the user and pause until it is registered:
  61.  
  62. -DOORSTOP- By Scott Johnson (C) 1993 Jibben Software, All rights reserved.
  63.  
  64. UNREGISTERED VERSION
  65. Please register this software after 21 days or remove from the system.
  66.  
  67. Also,  the timing functions will not be available until this version is
  68. registered and there will be a pause before the text is displayed.
  69.  
  70. Here's what you get when you register (Please use ORDERFRM.DOC to order 
  71. this software):
  72.  
  73. 1.  Support.  You can call and leave e-mail to me on the BBS listed in
  74.     the Technical Support section of this document or CompuServe and
  75.     get a response from me.  I will more than likely answer all
  76.     questions, but the registered individuals will definitely get top
  77.     priority.  You will also receive unlimited telephone support for
  78.     the program.  Registered users will get a phone number that they
  79.     will be able to use to receive support between the hours of 6:00 pm
  80.     - 9:00 pm (Central Standard Time) Monday-Friday.
  81.  
  82. 2.  You will receive a disk with the most recent version of Doorstop
  83.     The software will also have all of the registration incentives
  84.     removed.  The name and serial number of your BBS will also be
  85.     displayed in the main menu when the software is run.
  86.  
  87. 3.  Special access to new products.  You will be allowed access to
  88.     beta test any software package that I'm in the process of creating.
  89.     The beta software will be available only on the Warehouse BBS.
  90.     Also you must make arrangements with Jibben Software to get access
  91.     to the new software.  (see Technical Support section of this
  92.     document for details).
  93.  
  94. 4.  You will be able to download and upgrade your registered version
  95.     with the shareware releases of minor revisions (1.01, 1.10,
  96.     1.90...).
  97.  
  98. 5.  You will also have low cost upgrades for major revisions (2.0,
  99.     3.0...) of this software.
  100.  
  101.  
  102.                            What is Doorstop?
  103.  
  104. Doorstop is geared for Sysops wanting a little more control inbetween 
  105. doors.  Have you ever wanted to lockout certain user from a door? Block 
  106. out certain age groups? Display a message to all users before they 
  107. enter a door?  Shut a door down during a certain time to run 
  108. maintenence or leave the board open for other uses?  Have only a 
  109. certain group of people to access a certain door?  Restrict usage to a
  110. certain user level?  Then this program was written just for you.
  111.  
  112.                      Where did the idea come from?
  113.  
  114. On a board that I help run the SysOp posed a certain question, "How can 
  115. I display a message to all users letting them know of an external 
  116. interface that is available to download or to let the users know that I 
  117. am going to reset the game?  How can I close the door down so I insure 
  118. clean data while the maintenence is running?" So the first generation 
  119. of Doorstop (then called Doormat) was created.  From there I received 
  120. several other tips from people that wanted to lock out all users under 
  121. 18 for adult only type doors, and another person that wanted to lock out 
  122. certain troublesome users from a storyboard that was ruined several times.  
  123. So I set to work on the whole picture, and came up with the final version 
  124. and here it is.  I'm open to all comments or questions so if you have 
  125. anymore ideas, let me know.
  126.  
  127.  
  128.  
  129.                        Requirements for Doorstop
  130.  
  131.  
  132. Doorstop should have at least 100KB of free memory to run.
  133.  
  134.  Supported BBS Systems
  135. ---------------------
  136. Doorstop will support any BBS that creates a DOOR.SYS file when chaining
  137. to a door.  Also, Wildcat 2.x (CALLINFO.BBS), DORINFOx.DEF and
  138. PC Board - 12.x through 14.x (PCBOARD.SYS) are supported.
  139.  
  140.  
  141.               Installation Instructions
  142.  
  143. Sample Door Batch File
  144. ----------------------
  145. The door filename is placed on the command line of DOORSTOP.EXE.  Here is a
  146. sample batch file calling Doorstop before entering Jibben Software's
  147. Galactic Overload door game.  This example assumes the following:
  148.     DOORSTOP.EXE is in the DOS PATH or in the door directory
  149.     DOOR.SYS and DOORSTOP.DEF is in the door directory
  150.  
  151. C:                             ( change drives )
  152. CD\DOORS\GO                    ( change to door directory )
  153. DOORSTOP DOOR.SYS DOORSTOP.DEF ( run DOORSTOP )
  154. IF NOT ERRORLEVEL 0 GOTO END   ( * )
  155. GO DOOR.SYS                    ( run Jibben Software's Galactic Overlord )
  156. :END                           ( END header for escaping batch file if error
  157. CD\                            ( change back to the root directory )
  158.  
  159. ( * ) This line checks to see if an error occurs and exits the batch file
  160.       without entering the main door.  
  161.       A list of errorlevel codes follow:
  162.  
  163.     Errorlevel -1    Fatal error; caller hung up, files missing, etc...
  164.     Errorlevel 0     No problems; ok to run next door
  165.     Errorlevel 1     User hit door closed times - registered version only
  166.     Errorlevel 2     User is under age
  167.     Errorlevel 3     User was on the exclude list
  168.     Errorlevel 4     User was above or below security access restriction
  169.  
  170.  
  171. Non-Standard Comm Ports
  172. -----------------------
  173. If you have a DigiBoard system or are using Fossil drivers you can
  174. still use this door game!  You will have to add another parameter to
  175. the door batch file.  The format of this next parameter is PORT:AAAA:X.
  176.  
  177. *** NOTE: ***
  178.  
  179. The dos batch errorlevels, from testing and working with them, seem to 
  180. not allow the "NOT ERRORLEVEL 0".  You may try this, HOWEVER, if this 
  181. does not work then replace the line "IF NOT ERRORLEVEL 0 GOTO END" with
  182. the following lines:
  183.  
  184. IF ERRORLEVEL  4 GOTO END
  185. IF ERRORLEVEL  3 GOTO END
  186. IF ERRORLEVEL  2 GOTO END
  187. IF ERRORLEVEL  1 GOTO END
  188. IF ERRORLEVEL -1 GOTO END
  189.  
  190.  
  191.                Doorstop Examples
  192.  
  193.  
  194. The following batch file would request a port using interrupt 4 at
  195. address 03F8.
  196.  
  197. C:  
  198. CD\DOORS\GO 
  199. DOORSTOP DOOR.SYS PORT:03F8:4 DOORSTOP.DEF 
  200. IF NOT ERRORLEVEL 0 GOTO END 
  201. GO DOOR.SYS PORT:03F8:4 
  202. END:  
  203. CD\
  204.  
  205. The following batch file would request port #3 on a DigiBoard.
  206.  
  207. C:
  208. CD\DOORS\GO
  209. DOORSTOP DOOR.SYS PORT:D:3 DOORSTOP.DEF
  210. IF NOT ERRORLEVEL 0 GOTO END
  211. GO DOOR.SYS PORT:D:3
  212. END:
  213. CD\
  214.  
  215. The following batch file would request port #2 on a Fossil Driver.
  216.  
  217. C:
  218. CD\DOORS\GO
  219. DOORSTOP DOOR.SYS PORT:F:2 DOORSTOP.DEF
  220. IF NOT ERRORLEVEL 0 GOTO END
  221. GO DOOR.SYS PORT:F:2
  222. END:
  223. CD\
  224.  
  225. Local Mode
  226. ----------
  227. The door can be tested in local mode, although, you'll have to use a
  228. DOOR.SYS file that has a comm port of zero (COM0:).  The following
  229. files are included:
  230.  
  231. LOCAL.BAT
  232. DOOR.SYS
  233.  
  234. Simply typing LOCAL with the above files in the same directory as the
  235. other Doorstop distribution files will start the door in local mode.
  236.  
  237.  
  238. Miscellaneous Setup Issues
  239. --------------------------
  240. Doorstop supports multi-node access!  So, you can safely allow
  241. more than one node to access the door at one time.  To best way to
  242. accomplish this is to place DOORSTOP.EXE somewhere in the search path.
  243. When registering, place the overlay file in the SAME directory as
  244. the DOORSTOP.EXE file.  However, you will be responsible for keeping
  245. each DOOR.SYS or related door file separate from other players files.
  246.  
  247.  
  248.  
  249.               Configuration
  250.  
  251. Doorstop has been written to be easily configured.  Included with this
  252. distribution software is a file named Doorstop.DEF ( or whatever you wish
  253. to call it).  It is very similar to a Microsoft Windows *.INI file.  It
  254. contains a sample configuration for the utility.  It also contains the
  255. documentation for the settings and what the options mean.  Please refer
  256. to this file to see how to configure your copy of Doorstop.
  257.  
  258.  
  259.  
  260.                        Doorstop Technical Info
  261.  
  262. Files
  263. -----
  264. Doorstop is the first door utility released by Jibben Software.  And is also
  265. the first program ever released by the author Scott Johnson.
  266.  
  267. The only files that Doorstop requires are:
  268. Doorstop.DEF       - Doorstop configuration file.
  269. Doorstop.EXE       - Doorstop executable.
  270.  
  271. All other distribution files may be removed to conserve disk space.
  272.  
  273.  
  274.             Special Sysop Functions
  275.  
  276.  
  277. On-Line Sysop Commands
  278. ----------------------
  279.  
  280. While a caller is on-line, the local sysop has several options:
  281.  
  282.  
  283. FKey      Description
  284. -------   --------------------------------------------
  285.  F3*      Toggle printer on/off
  286.  F4*      Toggle pagebell on/off
  287.  F5       Shell to DOS
  288.  F7*      Toggle caller alarm on/off
  289.  F8       Return user to system
  290.  F9       Toggle display on/off
  291.  
  292. Alt-Key   Description
  293. -------   --------------------------------------------
  294.  ALT-H    Toggle between different status lines
  295.  ALT-N*   Toggle sysop on next
  296.  ALT-X*   Toggle exit to dos after call and help lines
  297.  
  298.  
  299. Alternately pressing the ALT-H key will bring up the next status line
  300. screen.  The 1st screen is a help screen, the second screen shows your
  301. COM port status.
  302.  
  303. *The function keys marked with an "*" will only be of use to systems
  304. using pcboard.sys.  The rest are functional with any system.
  305.  
  306.  
  307.                          Why cripple software?
  308.  
  309.    A common practice for Shareware authors has been appearing, software 
  310. crippling.  This unfortunate occurance is needed to insure the author's 
  311. time and effort is compensated for.  Please understand how much time 
  312. and effort goes into each program that is written.  
  313.  
  314.  
  315.                Development Data
  316.  
  317. Doorstop was written entirely in C++ using Borland C++ 3.1.
  318.  
  319.  
  320.                            Technical Support
  321.  
  322. For technical support I (Scott Johnson) can be reached at the following
  323. on-line systems:
  324.  
  325. The Warehouse BBS:  612-379-8272  1200-57600 baud V.32bis/HST 16.8K
  326. (N81) - 10 Lines.  The Warehouse is my first (main) line of support.
  327. Since I am a co-sysop of this BBS, I usually log on several times a day
  328. to check for email.  This BBS is a subscription BBS, however anyone
  329. logging on will receive access rights to the file area where my
  330. software can be downloaded for FREE and a message area that is
  331. dedicated to Jibben Software.
  332.  
  333. Door-Util conference from FIDO.  I will be reading all messages sent to 
  334. me in this forum, but will respond as time permits.  Of course, 
  335. registered users will get a response right away.
  336.  
  337.                 Acknowledgments
  338.  
  339. I would like to thank those people that have assisted me in the
  340. development of this software:
  341.  
  342. Scott Jibben, a darn good programmer and friend who gave me Jibben libraries
  343. to simplify and speed up development of this project and others to come...
  344.  
  345. Travis Carter, SysOp of the Warehouse BBS, for testing the software and
  346. providing a message forum for supporting software written by Jibben Software.
  347.  
  348. My wife, for being patient and supportive in getting this software written
  349. and out.
  350.  
  351. Finally, all of the people who've registered my software.  I really
  352. appreciate it!
  353.  
  354.                Disclaimers, etc.
  355.  
  356. Jibben Software specifically disclaims all other warranties, expressed
  357. or implied, including but not limited to implied warranties of
  358. merchantability and fitness for a particular purpose, functionality or
  359. data integrity.  In no event shall Jibben Software be liable for any
  360. loss of profit or any other commercial damage, including but not
  361. limited to special, incidental, consequential or other damages.
  362.  
  363.  
  364. Borland is a registered trademark of Borland International, Inc.
  365. Microsoft Windows is a registered trademark of Microsoft Corporation.
  366. DigiBoard is a registered trademark of DigiBoard Corp.
  367.  
  368.